home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / pmprobe.z.z / pmprobe.z / pmprobe
Text File  |  1997-04-03  |  10KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))                                                          PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmpppprrrroooobbbbeeee - lightweight probe for performance metrics
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmpppprrrroooobbbbeeee [----IIIIiiiiVVVVvvvv] [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t_n_a_m_e] [----nnnn _n_a_m_e_s_p_a_c_e] [_m_e_t_r_i_c_n_a_m_e
  13.      ...]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmpppprrrroooobbbbeeee determines the availability of performance metrics exported
  17.      through the facilities of the Performance Co-Pilot (PCP).
  18.  
  19.      The metrics of interest are named in the _m_e_t_r_i_c_n_a_m_e arguments.  If
  20.      _m_e_t_r_i_c_n_a_m_e is a non-leaf node in the namespace (see ppppmmmmnnnnssss(4)), then
  21.      ppppmmmmpppprrrroooobbbbeeee will recursively descend the PMNS and report on all leaf nodes.
  22.      If no _m_e_t_r_i_c_n_a_m_e argument is given, the root if the namespace is used.
  23.  
  24.      The output format is spartan and intended for use in wrapper scripts
  25.      creating configuration files for other PCP tools.  By default, there is
  26.      one line of output per metric, with the metric name followed by a count
  27.      of the number of available values.  Error conditions are encoded as a
  28.      negative value count (as per the PPPPMMMMAAAAPPPPIIII(3) protocols) and followed by a
  29.      textual description of the error.
  30.  
  31.      Other options control the output of additional information when one or
  32.      more values is available.
  33.  
  34.      ----iiii   Report the internal identifiers for each instance.  The values are
  35.           in decimal and prefixed by ``?''.  As a special case, the literal
  36.           string PPPPMMMM____IIIINNNN____NNNNUUUULLLLLLLL is reported for singular metrics.
  37.  
  38.      ----IIII   Like ----iiii, except the external instance identifiers are reported,
  39.           enclosed by quotes.
  40.  
  41.      ----vvvv   Report the value for each instance, as per the formatting rules of
  42.           ppppmmmmPPPPrrrriiiinnnnttttVVVVaaaalllluuuueeee(3).
  43.  
  44.      The ----vvvv, ----iiii and ----IIII options are mutually exclusive.
  45.  
  46.      Unless directed to another host by the ----hhhh option, ppppmmmmpppprrrroooobbbbeeee will contact
  47.      the Performance Metrics Collector Daemon (PMCD) on the local host.
  48.  
  49.      The ----aaaa option causes ppppmmmmpppprrrroooobbbbeeee to use the specified archive rather than
  50.      connecting to a PMCD.  The ----aaaa and ----hhhh options are mutually exclusive.
  51.  
  52.      Normally ppppmmmmpppprrrroooobbbbeeee operates on the default Performance Metrics Namespace
  53.      (PMNS), however if the ----nnnn option is specified an alternative namespace is
  54.      loaded from the file _n_a_m_e_s_p_a_c_e.  Independent of the ----nnnn option, the
  55.      namespace is always local to machine on which ppppmmmmpppprrrroooobbbbeeee is run.
  56.  
  57.      The ----VVVV option provides a cryptic summary of the number of messages sent
  58.      and received across the PMAPI interface.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))                                                          PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))
  71.  
  72.  
  73.  
  74. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  75.      _$$$$ _pppp_mmmm_pppp_rrrr_oooo_bbbb_eeee _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv
  76.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._rrrr_eeee_aaaa_dddd _2222
  77.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._wwww_rrrr_iiii_tttt_eeee _2222
  78.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._tttt_oooo_tttt_aaaa_llll _2222
  79.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._bbbb_llll_kkkk_rrrr_eeee_aaaa_dddd _2222
  80.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._bbbb_llll_kkkk_wwww_rrrr_iiii_tttt_eeee _2222
  81.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._bbbb_llll_kkkk_tttt_oooo_tttt_aaaa_llll _2222
  82.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._aaaa_cccc_tttt_iiii_vvvv_eeee _2222
  83.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._rrrr_eeee_ssss_pppp_oooo_nnnn_ssss_eeee _2222
  84.  
  85.      _$$$$ _pppp_mmmm_pppp_rrrr_oooo_bbbb_eeee _----_IIII _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._rrrr_eeee_aaaa_dddd _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._wwww_rrrr_iiii_tttt_eeee _\\\\
  86.        _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._aaaa_llll_llll_...._tttt_oooo_tttt_aaaa_llll
  87.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._rrrr_eeee_aaaa_dddd _2222 _""""_dddd_kkkk_ssss_0000_dddd_1111_"""" _""""_dddd_kkkk_ssss_0000_dddd_2222_""""
  88.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._wwww_rrrr_iiii_tttt_eeee _2222 _""""_dddd_kkkk_ssss_0000_dddd_1111_"""" _""""_dddd_kkkk_ssss_0000_dddd_2222_""""
  89.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._aaaa_llll_llll_...._tttt_oooo_tttt_aaaa_llll _1111 _PPPP_MMMM______IIII_NNNN______NNNN_UUUU_LLLL_LLLL
  90.  
  91.      _$$$$ _pppp_mmmm_pppp_rrrr_oooo_bbbb_eeee _----_vvvv _pppp_mmmm_cccc_dddd_...._nnnn_uuuu_mmmm_aaaa_gggg_eeee_nnnn_tttt_ssss _pppp_mmmm_cccc_dddd_...._vvvv_eeee_rrrr_ssss_iiii_oooo_nnnn _pppp_mmmm_cccc_dddd_...._cccc_oooo_nnnn_tttt_rrrr_oooo_llll_...._tttt_iiii_mmmm_eeee_oooo_uuuu_tttt
  92.      _pppp_mmmm_cccc_dddd_...._nnnn_uuuu_mmmm_aaaa_gggg_eeee_nnnn_tttt_ssss _1111 _9999
  93.      _pppp_mmmm_cccc_dddd_...._vvvv_eeee_rrrr_ssss_iiii_oooo_nnnn _1111 _""""_2222_...._0000 _bbbb_eeee_tttt_aaaa_----_1111_""""
  94.      _pppp_mmmm_cccc_dddd_...._cccc_oooo_nnnn_tttt_rrrr_oooo_llll_...._tttt_iiii_mmmm_eeee_oooo_uuuu_tttt _1111 _5555
  95.  
  96.      _$$$$ _pppp_mmmm_pppp_rrrr_oooo_bbbb_eeee _----_vvvv _dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._tttt_oooo_tttt_aaaa_llll _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._aaaa_llll_llll_...._tttt_oooo_tttt_aaaa_llll
  97.      _dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._tttt_oooo_tttt_aaaa_llll _----_1111_0000_1111_2222 _UUUU_nnnn_kkkk_nnnn_oooo_wwww_nnnn _mmmm_eeee_tttt_rrrr_iiii_cccc _nnnn_aaaa_mmmm_eeee
  98.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._aaaa_llll_llll_...._tttt_oooo_tttt_aaaa_llll _1111 _4444_9999_9999_2222_4444_6666_6666
  99.  
  100. FFFFIIIILLLLEEEESSSS
  101.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////*         default PMNS specification files
  102.  
  103. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  104.      ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmiiiinnnnffffoooo(1), PPPPMMMMAAAAPPPPIIII(3), ppppmmmmEEEErrrrrrrrSSSSttttrrrr(3),
  105.      ppppmmmmPPPPaaaarrrrsssseeeeTTTTiiiimmmmeeeeWWWWiiiinnnnddddoooowwww(3) and ppppmmmmnnnnssss(4).
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.